Access Tutorial 10: Parameter Queries 


The last few tutorials have been primarily concerned 
with interface issues. In the remaining tutorials, the 
focus shifts to transaction processing. 


10.1 Introduction: Dynamic queries 
Using parameters 


A parameter query is a query in which the criteria 
for selecting records are determined when the query 
is executed rather than when the query is designed. 


For example, recall the select query shown in 

Figure 4.6. In this query, the results set is limited to 
records that satisfy the criterion DeptCode = 
“COMM”. If you wanted a different set of results, you 
would have to edit the query (e.g., change the crite- 
rion to “CPSC”) and rerun the query. 

However, if a variable (parameter) is used for the cri- 


terion, Access will prompt the user for the value of 
the variable before executing the query. The net 
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result is that parameters can be used to create 
extremely flexible queries. 


When the concepts from this tutorial are combined 
with action queries (Tutorial 11) and triggers 
(Tutorial 13), you will have a the skills required to 
create a simple transaction processing system with- 
out writing a line of programming code. 


10.2 Learning objectives 


O What is a parameter query? How do | create 
one? 


O How do | prompt the user to enter parameter 
values? 


O How do | create a query whose results 
depend on a value on a form? 


1of1i 


10. Parameter Queries 
10.3 Tutorial exercises 


10.3.1 Simple parameter queries 


e If you do not already have a qryCourses query 
like the one shown in Figure 4.6, create one now 
and save it under the name pgryCourses. 

* Replace the literal string in the criteria row 
(“COMM”) with a variable ([X]). 


By default, Access expects criteria to be literal 
A strings of text. As a result, it automatically 
adds quotation marks to text entered in the 
criteria row. To get around this, place your 
parameter names inside of square brackets. 


e Execute the query as shown in Figure 10.1. 


When Access encounters a variable (i.e., something 
that is not a literal string) during execution, it 
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attempts to bind the variable to some value. To do 
this, it performs the following tests: 


1. First, Access checks whether the variable is the 
name of a field or a calculated field in the query. If 
it is, the variable is bound to the current value of 
the field. For example, if the parameter is named 
[Dept Code], Access replaces it with the current 
value of the Dept Code field. Since x is not the 
name of a field or a calculated field in this particu- 
lar query, this test fails. 

2. Second, Access attempts to resolve the parame- 
ter as a reference to something within the current 
environment (e.g., the value on an open form). 
Since there is nothing called x in the current envi- 
ronment, this test fails. 

3. As a last resort, Access asks the user for the 
value of the parameter via the “Enter Parameter 
Value” dialog box. 
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FIGURE 10.1: Convert a select query into a parameter query. 


as! pqryCourses : Select Query 


as! pqryCourses : Select Query 


Enter Parameter Value 


x 
[comm 


Field: | DeptCode Cancel | 
Table: | Courses 
y = [I] 
eee Ascendino 
Show: 
Criteria: 


Courses Courses Courses 
: | Ascending Ascending PY 


sart 


10. Parameter Queries 


©) Note that the spelling mistakes discussed in 
Section 4.3.4 are processed by Access as 
parameters. 


10.3.2 Using parameters to generate 
prompts 

Since the name of the parameter can be anything 

(as long as it is enclosed in square brackets), you 

can exploit this feature to create quick and easy dia- 

log boxes. 

e Change the name of your DeptCode parameter 
from [X] to [Courses for which depart- 
ment?]. 

e Run the query, as shown in Figure 10.2. 


10.3.3 Values on forms as parameters 


A common requirement is to use the value on a form 
to influence the outcome of a query. For instance, if 
the user is viewing information about departments, it 
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may be useful to be able to generate a list of courses 
offered by the department currently being viewed. 
Although you could use a creatively-named parame- 
ter to invoke the “Enter Parameter Value” dialog, this 
requires the user to type in the value of Dept Code. 


A more elegant approach is to have Access pull the 
value of a parameter directly from the open form. 
This exploits the second step in the operation of a 
parameter query (Access will attempt to resolve a 
parameter with the value of an object within the cur- 
rent environment). The basic idea is shown in 
Figure 10.3. 


The key to making this work is to provide a parame- 
ter name that correctly references the form object in 
which you are interested. In order to avoid having to 
remember the complex naming syntax for objects on 
forms, you can invoke the expression builder to 
select the correct name from the hierarchy of data- 
base objects. 
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FIGURE 10.2: Select a parameter name that generates a useful prompt. 


as’ pqryCourses : Select Query 


Enter Parameter Value A! 


Courses for which department? 


[Comm 


car | 


Field: |DeptCode Crum Title =] 
Table: | Courses = pqryCourses : Select Query 


Sort: ing 
Show -Departmenglesurse number, Te 
Introduction to Quantative Decision hy 


Criteria: | [Courses for which department?] 


or E. EI a Applied Statistics in Business 
E COMM 351 Financial Accounting 
m COMM 439 Advanced Topics in Information Syst 
== 


serti 
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FIGURE 10.3: Using the value on an open form as a parameter in a query. 


e! pqryCourses : Select Query -0f ES 


& Departments l=) Ei 
Department code [COMM 


Department name 


ommerce and Business Administr: 


EEEF 
DM il 


Field: 
Table: 
Sort: 
Show: 
Criteria: 
or: 


CrsNu 


Rar 


10. Parameter Queries Application to the assignment 


* Create a very simple form based on the Q Although the naming syntax of objects in 
Departments table and save it as frmDepart- Access is tricky, it is not impossible to com- 
ments. prehend. For example, the name 

* Leave the form open (in form view or design Forms! [frmDepartments] ! [DeptCode] 
mode, it does not matter). consists of the following elements: Forms 

* Open pgryCourses in design mode, place the refers to a collection of Form objects; [frm- 
cursor in the criteria row of the Dept Code field, Departments] is a specific instance of a 
and invoke the expression builder as shown in Form object in the Forms collection; [Dept — 
Figure 10.4. Code] is a Control belonging to the form. See 

* Perform the steps shown in Figure 10.5 to create Tutorial 14 for more information on the hierar- 
a parameter that references the Dept Code field chy of objects used by Access. 


on the frmDepartments form. 
Run the query. The results set should correspond 10.4 Application to the assignment 


to the department showing in the frmDepart - You will use parameter queries as the basis for sev- 
ments form. eral action queries (see Tutorial 11) that process 

* Move to a new record on the form. Notice that transactions against master tables. For now, simply 
you have to requery the form (Shift-F9) in order create the parameter queries that take their criteria 
for the new parameter value to be used (see values from forms you have already created. 
Figure 10.6). 
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FIGURE 10.4: Invoke the builder to build a parameter. 


& Departments -Iof x| 


as! pqryCourses : Select Query JD [X]Int code [COMM 


t name [Commerce and Business Administr: 
Building JANGU 
2 > | ot [>*| of 7 A 


I HITIRH MT IPPFII ll 
Field: 
Table: 


Sort [Ascending | [Ascending | | 
Show| Vv) FY | H | W | 
Criteria: 
or: Build... | 
Zoom... | 
J PA Rae 
Properties EEE ass 
Totals 


v Table Names 


Rar 


10. Parameter Queries Application to the assignment 


FIGURE 10.5: Use the builder to select the name of the object you want to use as a parameter. 


Expression Builder 


paryCourses <Form> 
+] Tables <Field List> 

dg DeptGpde Label 

Dept@ide 

Forms Deptilame Label 

© Loaded Forms DepiName 
LE Departments Building Label 


Baitding 
a- i Forms Form Header 
it] Repor 


x| |Detail 
> Form Footer 


E Queries 


Z 


10. Parameter Queries Application to the assignment 


FIGURE 10.6: Requery the results set to reflect changes on the form. 


as’ pqryCourses : Select Query | - (Oj x| 

|_ [Department | Course number| Title 

Introduction to Quantative Deets- 
Applied Statistics in Busines 

Financial Accounting 

E Departments olx] 


> de [MATH 
Eesti < a=? pqryCourses : Select Query | - |} x| 
Department name [Math | _|Department | Course number 


Building [MATH > | MATH 303 Introduction to Stochastic Proces 
|| MATH 407 Applied Matrix Analysis 
Record: I4| 4 II 6 > | rtp 


& Departments 
Department code [MATH 
Department name [Math 


Building [MATH 
Record: I4| 4 II 6 b | >t [>| of 7 Z 


wort 


10. Parameter Queries 


* Create a parameter query to show all the order 
details for a particular order. 

* Create a second parameter query to show all the 
shipment details for a particular shipment. 


Each order may result in a number of changes being 
made to the BackOrders table. For some items in 
the order, more product is ordered than is actually 
shipped (i.e., a backorder is created). For other 
items, more product is shipped than is ordered (i.e., 
a backorder is filled). 


In Tutorial 15, you are supplied with a “shortcut” 
Visual Basic procedure that makes the changes to 
the BackOrders table for you. However, the short- 
cut procedure requires a query that lists the changes 
that must be made to the BackOrders table fora 
particular order. The requirements for this query are 
the following: 

* The name of the query is 

pagryItemsToBackOrder 


Application to the assignment 


* It shows the change (positive or negative but not 
zero) in backorders for each item in a particular 
order. 

e The query consist of three fields: Order ID, Pro- 
duct ID and a calculated field Qty (i.e., the 
change in the back order for a particular product). 

* The name of the parameter is in this query is sim- 
ply [pOrderID]. Since the value of this parame- 
ter will be set by the Visual Basic shortcut before 
the query is run, there is no need to set it to a 
value on a form. 


Since the query is accessed by a program, 
the name of the query and all the fields must 
be exactly as described above. In other 
words, you are given a precise specification 
for a database object that fills a role in a pro- 
cess designed and implemented by someone 
else. You will not understand how the query 
fits in until Tutorial 15. 
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